home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / icos114e.zip / ICOSHOW.TXT < prev    next >
Text File  |  1993-01-13  |  49KB  |  1,272 lines

  1.  
  2.  
  3. Documentation of Program IcoShow
  4.  
  5.  
  6.  
  7.        Version             1.14e
  8.  
  9.        Date                January, 13th 1993
  10.  
  11.  
  12.  
  13.        Register at         Harald Pitro
  14.                            Hermann-Wuensche-Strasse 11
  15.                            O - 8705 Ebersbach / Sachsen
  16.                            Germany
  17.  
  18.        Phone               +49-3586-5186
  19.        CompuServe          100024, 2662
  20.  
  21.        Registration for    $35 (60.- DM within Germany)
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                      Table of Contents
  30.  
  31.     1. Overview                                           
  32.     2. System Requirements and Limits                     
  33.     3. Start and Command Line                             
  34.     4. INI file                                           
  35.          4.1 Application [IcoShow]                        
  36.          4.2 Application [Groups]                         
  37.     5. Menu Commands                                      
  38.          5.1  File Menu                                   
  39.          5.2  Icons Menu                                  
  40.               5.2.1 Copy / Move                           
  41.               5.2.2 Rename / Edit                         
  42.               5.2.3 Select                                
  43.               5.2.4 Exclude                               
  44.          5.3  Options Menu                                
  45.               5.3.1 Edit with ...                         
  46.               5.3.2 Repair Icons                          
  47.               5.3.3 Save Settings                         
  48.               5.3.4 Quick Delete                          
  49.               5.3.5 Quick Search                          
  50.          5.4  Window Menu                                 
  51.          5.5  Help Menu                                   
  52.          5.6  Properties Menu                             
  53.     6. Dialog Boxes                                       
  54.          6.1  Open                                        
  55.          6.2  Print Icons                                 
  56.          6.3  Create Library                              
  57.          6.4  Select Icons                                
  58.          6.5  Exclude Icons                               
  59.          6.6  Edit with ...                               
  60.          6.7  Rename Icon                                 
  61.          6.8  Select Window                               
  62.          6.9  Registration                                
  63.          6.10 Print Order Form                            
  64.          6.11 About IcoShow                               
  65.     7. Status Line                                        
  66.     8. Hints for the use of IcoShow                       
  67.     9. Shareware Version                                  
  68.  
  69.  
  70.  
  71. 1. Overview
  72.  
  73. The  amount of present icons for Windows requires a simple
  74. management  and  the  possibility to  process  icons  from
  75. management, to group them by anyone and to write  them  to
  76. icon files or libraries.
  77.  
  78. IcoShow  searches for icons and libraries  with  icons  in
  79. selected drives and/or directories (in subdirectories also
  80. if wished) and shows the icons including their names. Each
  81. directory including icons becomes a new window. After  you
  82. have started IcoShow you can add directories at any time.
  83.  
  84. You  can copy or move icons from one window to another  by
  85. dragging  them with the mouse. If you minimize  a  window,
  86. all  selected  icons will be copied or moved  with  window
  87. icon.  If you wish to process only a part of the icons  in
  88. windows,  you can select/exclude icons by pattern  strings
  89. that matches the icon names.
  90.  
  91. You  can write the selected icons from one window  or  all
  92. windows to a new library. In one library you can hold over
  93. 2,700  icons but if you write more than 1,200 icons  to  a
  94. library  this  library  can not be used  in  another  icon
  95. manager or program manager. You can exclude duplicates  of
  96. icons while writing them to a library.
  97.  
  98. You  can  choose  an  icon editor to  process  icons  from
  99. IcoShow  directly.  If  the editor chosen  is  capable  of
  100. command   line  processing,  the  icon  will   be   opened
  101. automatically and presented for editing.
  102.  
  103. If  you wish to install icons in program manager, you need
  104. only to drag them from the IcoShow window to the window of
  105. the program manager using the mouse.
  106.  
  107. Icons or all icons selected in a window can be deleted  by
  108. the DEL key (you cannot delete icons within libraries). If
  109. you are an experienced user, you can delete them simply by
  110. dragging  them  outside  of  screen.  Please  be  careful,
  111. IcoShow do not undelete icons!
  112.  
  113. Some  older icon files contains bugs (the program  manager
  114. shows you a truncated icon image). IcoShow lets repair you
  115. this bug.
  116.  
  117. You   can   print  icons  with  any  matrix,  ink-jet   or
  118. laserprinter  (postscript also). You  may  also  print  in
  119. color if your printer can handle the output.
  120.  
  121. IcoShow  writes the current status of the options and  his
  122. desktop in the file ICOSHOW.INI.
  123.  
  124. In  a  status line you can see the most important  options
  125. and some informations about the processed icons.
  126.  
  127. If  you need help, press F1 at any time. IcoShow will  try
  128. to find the proper help for you.
  129.  
  130.  
  131. 2. System Requirements and Limits
  132.  
  133. IcoShow  will  run under Windows 3.0 and 3.1  in  standard
  134. mode  as well as in enhanced mode. It will not run in real
  135. mode because there is not enough heap space.
  136.  
  137. IcoShow  shows the proper image for the display from  each
  138. icon.  If  you  have a monochrome card, you will  not  see
  139. icons   that  only  contain  color  images.  But   IcoShow
  140. processes the icon files with all images!
  141.  
  142. The  amount  of  icons you can process  depentend  on  the
  143. amount  of  displayed  windows. IcoShow  can  display  and
  144. process up to 16,384 icons.
  145.  
  146. Look at the dialog box "About IcoShow" (Help Menu) to  see
  147. the  use  of heap and resources. Check these informations.
  148. If  you  see that "Free Heap" is very small, close windows
  149. to  free  local  heap.  An overflow in  local  heap  stops
  150. IcoShow immediately.
  151. If  there  are no more windows or dialog boxes  displayed,
  152. you have too many opened windows.
  153.  
  154. IcoShow  supports libraries of types DLL/NIL/ICL.  IcoShow
  155. will  warn  you if you try to write more than 1,200  icons
  156. into  a library. You can save over 2,700 icons within  one
  157. library  but this library will not be applicable by  other
  158. icon managers (program manager also).
  159. 3. Start and Command Line
  160.  
  161. You  will  usually  start  IcoShow  without  command  line
  162. arguments. If you want to use command line processing, the
  163. syntax is:
  164.  
  165.  
  166.     ICOSHOW [-s] [Directory ...]
  167.  
  168.  
  169.   -s       Include subdirectories (you can type /s for -s).
  170.   
  171.   -d       Don't use BWCC.DLL
  172.   
  173.   Directory  Drive and path including icons possibly.
  174.  
  175.  
  176. Example :       ICOSHOW -s c: d:
  177.  
  178. searches  for  icons the drives 'c'  und  'd',   including
  179. all subdirectories, and shows all directories with icons.
  180.  
  181. Hint:   If  you start IcoShow with command line arguments,
  182.         the  saved  desktop in INI file  will  be  ignored
  183.         (see also below).
  184.  
  185.  
  186.  
  187. 4. INI file
  188.  
  189. IcoShow  saves an INI file with the status of the  options
  190. and  the  last desktop. So you can continue with the  same
  191. environment at the next session. The key names must follow
  192. the  application names [IcoShow] and [Groups].  Upper  and
  193. lower case is the same.
  194.  
  195.  
  196. 4.1 Application [IcoShow]
  197.  
  198. Example :
  199.  
  200. Application/Key                             Default
  201. [IcoShow]
  202. SaveSettings=1                              (0)
  203. SubDir=On                                   (Off)
  204. Libraries=Exe,Dll,Nil,Icl                   (,,)
  205. SearchNames=Off                             (On)
  206. LibName=c:\win\icons.dll                    (-)
  207. Run=imagedit                                (-)
  208. Repair=On                                   (Off)
  209. Tool=Move                                   (Copy)
  210. Rename=On                                   (Off)
  211. QuickDelete=On                              (Off)
  212. QuickSearch=On                              (On)
  213. Select=A*                                   (-)
  214. Exclude=AB*                                 (-)
  215. Minimize=On                                 (Off)
  216. Arrange=Tile                                (Cascade)
  217. BackColor=191,191,191                       (-)
  218. Window=0 0 640 480 3                        (-)
  219. Registered=Gustav Hackendahl                (-)
  220. Password=0815                               (-)
  221.  
  222. Enclosed  in  brackets are the default values  if  IcoShow
  223. does  not  find an INI file. You can change  the  settings
  224. while IcoShow is running (exception: "BackColor").
  225.  
  226.  
  227. Explanation of the example atop:
  228.            
  229. "SaveSettings=1"   IcoShow will save the settings  of  the
  230.                    options and his desktop on exit.
  231.  
  232. "SubDir=On"        If  you  add directories and/or drives,
  233.                    IcoShow   will  search  for  icons   in
  234.                    subdirectories also.
  235.  
  236. "Libraries=Exe,Dll,Nil,Icl"  IcoShow searches for icons in
  237.                    libraries also. If IcoShow searches for
  238.                    ICO   files   only,  this   key   reads
  239.                    "Libraries=,,,".
  240.  
  241. "SearchNames=Off"  Some  libraries contain names  for  the
  242.                    including  icons. If this statement  is
  243.                    "On",  IcoShow  will  search  for   the
  244.                    names.  If this option is "Off"  or  if
  245.                    icons  have no names, IcoShow will  use
  246.                    the  library  name  for  the  including
  247.                    icons.
  248.  
  249. "LibName=c:\win\icons.dll"    This statement contains  the
  250.                    full  name of the last written  library
  251.                    and  will be the default name  for  the
  252.                    next.
  253.  
  254. "Run=imagedit"     If  the  option "Rename"  is  "Off",  a
  255.                    double click with the mouse will  start
  256.                    the  icon  editor chosen  here  (or  in
  257.                    Option Menu). IcoShow appends the  full
  258.                    icon name and starts the program.
  259.  
  260. "Repair=On"        If  this  option is "On", IcoShow  will
  261.                    repair  bugs  in older  icon  files  on
  262.                    disk.  Bugs  in libraries will  not  be
  263.                    repaired.  IcoShow repairs bugs  always
  264.                    while running.
  265.  
  266. "Tool=Move"        Icons  will  be moved by dragging  them
  267.                    with the mouse.
  268.  
  269.                    If "Tool=Copy", icons will be copied.
  270.  
  271. "Rename=On"        If  this option is "On", a double click
  272.                    with  the mouse will open a dialog  box
  273.                    to  rename  the current icon.  If  this
  274.                    option is "Off", IcoShow will start the
  275.                    icon editor selected (see upon).
  276.  
  277. "QuickDelete=On"   If  you  press the Del key, the current
  278.                    icon (or all icons in current window if
  279.                    minimized)  will  be  deleted.  IcoShow
  280.                    will  prompts you to confirm  that.  If
  281.                    you  are  an experienced user, you  can
  282.                    delete  icons by dragging them  outside
  283.                    of  screen.  In this case IcoShow  will
  284.                    not  warn you. Please be careful.  Hold
  285.                    this  option "Off" until you  are  sure
  286.                    you want to delete icons.
  287.  
  288. "QuickSearch=On"   If  this  option is "On", you can  find
  289.                    icons  by names quickly. Type simply  a
  290.                    string.  IcoShow tries to  find  proper
  291.                    icons  in  the current window.  IcoShow
  292.                    searches  with each character you  have
  293.                    entered successively. If no proper icon
  294.                    names have been found, the string  will
  295.                    be deleted.
  296.                    You  can see the current string in  the
  297.                    status  line. Look at point  5.3.5  for
  298.                    more details.
  299.  
  300. "Select=A*"        Under this statement IcoShow reads  the
  301.                    current pattern used to select icons by
  302.                    names  for processing. The term  A*  in
  303.                    the  example  causes  to  display  only
  304.                    icons which names start with "A" in all
  305.                    windows.  You can process only selected
  306.                    icons (the term "*.*" processes all  of
  307.                    them)!
  308.                    This  entry  is  a  readonly.  You  can
  309.                    change  the  setting while  IcoShow  is
  310.                    running but it will not be saved in the
  311.                    INI file.
  312.                    For more details about this pattern see
  313.                    5.2.3.
  314.  
  315. "Exclude=AB*"      Similar   to  the  "Select"   statement
  316.                    IcoShow reads the current pattern  used
  317.                    to   exclude   icons  by   names   from
  318.                    processing.  This example  common  used
  319.                    with  "Select=A*" displays icons  which
  320.                    names  start  with the letter  "A"  and
  321.                    which names do not have the letter  "B"
  322.                    at second place.
  323.                    This  entry  is  a  readonly.  You  can
  324.                    change  the  setting while  IcoShow  is
  325.                    running,  but it will not be  saved  in
  326.                    the INI file.
  327.                    For more details about this pattern see
  328.                    5.2.4.
  329.  
  330. "Minimize=On"      This   statement  causes   IcoShow   to
  331.                    display windows minimized on create.
  332.  
  333. "Arrange=Tile"     IcoShow   displays  all  not  minimized
  334.                    windows  als  "Tile". "Arrange=Cascade"
  335.                    shows the windows as "Cascade".
  336.  
  337. "BackColor=191,191,191"   This   statement  contains   the
  338.                    background  color  for  the   displayed
  339.                    icons.  If it's missing, the background
  340.                    will   be   the  same  as  the   window
  341.                    background.
  342.                    You  can not change this setting  while
  343.                    IcoShow is running.
  344.  
  345. "Window=0 0 640 480   3"    This  statement  contains  the
  346.                    position  and  the size  of  the  frame
  347.                    window:
  348.                    position of the upper left corner (0,0)
  349.                    size of the frame window (640x480)
  350.                          style  of  frame  window     
  351.                                            1 - normal
  352.                                            2 - minimized
  353.                                            3 - maximized
  354.  
  355. "Registered=Gustav Hackendahl"    Here stands your name.
  356.  
  357. "Password=0815"    The  password you get from author after
  358.                    you register the program.
  359.  
  360.  
  361.  
  362. 4.2 Application [Groups]
  363.  
  364. Example:
  365.  
  366. [Groups]
  367. Group1=c:\windows3\icons                                 4
  368. Window1=10 10 100 100                                    
  369. Group2=c:\windows3        Minimize                       0
  370. Window2=20 20 100 100                                    
  371. Group3=c:\windows3\system          EXEDLLNILICL          0
  372. Window3=30 30 100 100                                    
  373. Group4=c:\windows3\tools                          Active 0
  374. Window4=40 40 100 100                                    
  375.  
  376. For  each  line Groupi there must be a Windowi  line.  Key
  377. words within the lines are separated with Space or Tab.
  378.  
  379. "Minimize"         This window will be shown minimized.
  380.  
  381. "EXEDLLNILLICL"    In  this window will be included  icons
  382.                    from  the  library types Exe, Dll,  Nil
  383.                    and Icl. This key word is empty if only
  384.                    icons from ICO files will be included.
  385.  
  386. "Active"           This  key word marks the current active
  387.                    child window.
  388.  
  389. "0"                The  last  value is the number  of  the
  390.                    current icon in the window.
  391.  
  392. The statement "Windowi" contains the position and the size
  393. of the "Groupi" window.
  394.  
  395.  
  396.  
  397. 5. Menu Commands
  398.  
  399. 5.1  File Menu
  400.  
  401. In  the  File Menu you can open directories to select  the
  402. icons  existing there, print selected icons, create a  new
  403. icon library, refresh a directory window or exit IcoShow.
  404.  
  405.  
  406. Open             If you choose this menu command, a dialog
  407.                  box  will open to allow you to browse for
  408.                  the directory and/or drive wanted and  to
  409.                  check whether subdirectories and/or  icon
  410.                  libraries  (Exe/Dll/Nil/Icl)  are  to  be
  411.                  included and whether IcoShow is  to  look
  412.                  for   and  display  icon  names  in  some
  413.                  libraries.
  414.  
  415.                  Hint :  If the directory chosen does  not
  416.                          exist,  you  will be prompted  to
  417.                          allow IcoShow create it.
  418.  
  419. Print Icons      This command prints the selected icons in
  420.                  the current window on selected paper with
  421.                  any matrix, ink-jet or laser printer. You
  422.                  may  also print in color if your  printer
  423.                  can  handle  the output.  The  number  of
  424.                  printed  icons per sheet depends  on  the
  425.                  printer's resolution.
  426.                  The  description of the  dialog  box  you
  427.                  find at chapter 6.
  428.  
  429. Create Library   Transfers the selected icons from  either
  430.                  the current window or all windows into  a
  431.                  library.  Supported  library  types   are
  432.                  DLL/NIL/ICL.
  433.  
  434.                  You  can  put more than 2,700 icons  into
  435.                  such a library. But if you intent to  use
  436.                  the  library later with Window's  program
  437.                  manager  or with some other icon manager,
  438.                  you  should  not include more than  1,200
  439.                  icons. IcoShow will issue a warning.
  440.  
  441.                  For more details see chapter 6.
  442.  
  443. Refresh Directory Choose this option from System  Menu  if
  444.                  you wish to read icons and libraries from
  445.                  current directory again. Use this if  you
  446.                  have changed the content of the directory
  447.                  with  a  file  manager while  IcoShow  is
  448.                  running.
  449.  
  450. Exit IcoShow     Use   Hotkeys  Alt-F4  to  exit   IcoShow
  451.                  directly.
  452.  
  453.                  If  the  option  Save  Settings  (Options
  454.                  Menu)  has  been selected,  IcoShow  will
  455.                  save  all  settings including desktop  in
  456.                  ICOSHOW.INI   within  the  directory   of
  457.                  IcoShow.Exe.
  458.  
  459.  
  460.  
  461. 5.2  Icons Menu
  462.  
  463. Use  this menu to determine the function of the left mouse
  464. button  and  to select the icons to be used. All  commands
  465. under this menu are ineffectual if you drag an icon to the
  466. program manager!
  467.  
  468.  
  469. 5.2.1 Copy / Move
  470.  
  471. Choose here if you want to copy or to move icons with  the
  472. mouse.
  473.  
  474. Copy             You  can  drag  specific icons  or  icons
  475.                  symbolizing a minimized window containing
  476.                  icons  to  a destination window with  the
  477.                  mouse.  Place cursor on icon, press  down
  478.                  the left mouse button, then drag the icon
  479.                  to  its destination and release the mouse
  480.                  button.
  481.                  If  this  option is checked, the  icon(s)
  482.                  will be copied, not moved.
  483.  
  484. Move             You  can  drag  specific icons  or  icons
  485.                  symbolizing a minimized window containing
  486.                  icons  to  a destination window with  the
  487.                  mouse.  Place cursor on icon, press  down
  488.                  the left mouse button, then drag the icon
  489.                  to  its destination and release the mouse
  490.                  button.
  491.  
  492.                  If  this  option is checked, the  icon(s)
  493.                  will  be  moved, not copied.  This  means
  494.                  that  the icon files in the source window
  495.                  will be deleted after copying. Icons from
  496.                  libraries (Exe/Dll/Nil/Icl) will  not  be
  497.                  deleted, but copied.
  498.                  If  the  source  window  is  empty  after
  499.                  moving  icons, you will be  prompted  for
  500.                  deletion of the directory.
  501.  
  502.                  Hint : Icons with identical names in  the
  503.                          source       and      destination
  504.                          directories will not  be  deleted
  505.                          because they will not be moved.
  506.  
  507.  
  508.  
  509. 5.2.2 Rename / Edit
  510.  
  511. You can also choose the processing of the current icon  in
  512. this menu:
  513.  
  514. Rename           If this option is checked, you can rename
  515.                  icons by a double clicking them with  the
  516.                  mouse or by pushing the Return key. Icons
  517.                  cannot  be renamed and moved at the  same
  518.                  time.
  519.  
  520.                  If  you  wish  to sort the icons  in  the
  521.                  current  window  after  the  renaming  is
  522.                  done, check the sort button.
  523.  
  524.                  You cannot rename icons in libraries.
  525.  
  526. Edit             If this option is checked, a double click
  527.                  with the mouse or the Enter key will  run
  528.                  the  command  under  "Edit  with..."   in
  529.                  Options  Menu  for the icon selected.  If
  530.                  the  editor chosen is capable of  command
  531.                  line  processing, the icon will be opened
  532.                  and displayed for further processing.  If
  533.                  not, you will still have to open the icon
  534.                  you wish to alter.
  535.  
  536. IcoShow  displays  the current choose  within  the  status
  537. line.
  538.  
  539.  
  540.  
  541. 5.2.3 Select
  542.  
  543. If  you check this command, a dialog box will be presented
  544. for  you  to  enter  a pattern to select  icons  from  the
  545. contents of the Current Window to be displayed exclusively
  546. (and  for  all other windows also). The pattern "A*"  lets
  547. display you and process only icons which names start  with
  548. the letter "A".
  549.  
  550. The  following  characters may  be  used  in  the  pattern
  551. string:
  552.  
  553.  Letter/digit/./_ normal characters, upper and lower  case
  554.                   are not distinguished
  555.  ?                any character
  556.  *                a number of any characters
  557.  []               a class of characters
  558.  ^                negates the class of characters in []
  559.  -                a range of characters in  []
  560.  
  561. Examples for pattern:
  562.  
  563.  A*               all  icons, starting with the  letter  A
  564.                   as ALPHA.ICO
  565.  A                same
  566.  
  567.  A[ABCDE]         all  icons  starting with the  letter  A
  568.                   followed by one of the letters A, B, C,
  569.                   D or E
  570.  A[A-E]           same
  571.  A[^F-Z]          also the same if only letters possible
  572.  
  573. Please  watch  out  for interactions  between  Select  and
  574. Exclude.
  575.  
  576.  
  577.  
  578. 5.2.4 Exclude
  579.  
  580. If  you check this command, a dialog box will be presented
  581. for  you  to  enter a pattern to exclude  icons  from  the
  582. displayed  contents  of the Current Window  (and  for  all
  583. other windows also). The pattern "A*" lets display you and
  584. process  only  icons  which names do not  start  with  the
  585. letter "A".
  586.  
  587. The  following  characters may  be  used  in  the  pattern
  588. string:
  589.  
  590.  Letter/digit/./_ normal characters, upper and lower  case
  591.                   are not distinguished
  592.  ?                any character
  593.  *                a number of any characters
  594.  []               a class of characters
  595.  ^                negates the class of characters in []
  596.  -                a range of characters in  []
  597.  
  598. Examples for pattern:
  599.  
  600.  A*               all  icons, starting with the  letter  A
  601.                   as ALPHA.ICO
  602.  A                same
  603.  
  604.  A[ABCDE]         all  icons  starting with the  letter  A
  605.                   followed by one of the letters A, B, C,
  606.                   D or E
  607.  A[A-E]           same
  608.  A[^F-Z]          also the same if only letters possible
  609.  
  610. Please  watch  out  for interactions  between  Select  and
  611. Exclude.
  612.  
  613.  
  614.  
  615. 5.3  Options Menu
  616.  
  617. Set options for IcoShow.
  618.  
  619.  
  620. 5.3.1 Edit with ...
  621.  
  622. Here  you  can  enter a command line to process  a  chosen
  623. icon.  Type  the complete command line to start  the  icon
  624. editor  of your choice without the icon's name. That  will
  625. be  added  when you double click the mouse  or  press  the
  626. Return  key  and  if  the Edit option  in  Icons  Menu  is
  627. checked.
  628. If   the   editor  chosen  is  capable  of  command   line
  629. processing,  the  icon will be opened  and  presented  for
  630. editing  automatically. If not, only the program  will  be
  631. started and you will have to open manually the icon to  be
  632. edited.  Further procedure depends upon the editor itself.
  633. Do not forget to save the changes made!
  634.  
  635. If  the  icon has been changed by the selected program, it
  636. will be reloaded and redisplayed on exit.
  637.  
  638.                   Hint  :  Do not use programs changing
  639.                            file structures on disks.
  640.  
  641.  
  642. 5.3.2 Repair Icons
  643.  
  644. Older icon files may contain bugs (the icon's upper border
  645. is  truncated). You can have repaired these icon files  by
  646. checking  this  option.  Bugs in  libraries  will  not  be
  647. removed.
  648. IcoShow will correct this bug always while running.
  649.  
  650.  
  651.  
  652. 5.3.3 Save Settings
  653.  
  654. If  you  check  this  option, IcoShow  saves  the  current
  655. settings  of  all options and the desktop on exit  in  the
  656. file ICOSHOW.INI in the IcoShow directory. If missing,  it
  657. will be created by IcoShow automatically.
  658.  
  659. Use  Alt-Shift-F4  to save all settings including  desktop
  660. while  IcoShow is running (in this case the  option  "Save
  661. Settings" should not be checked).
  662.  
  663.               Hint :   A change of this option will always
  664.                        be saved to the INI file on exit.
  665.  
  666.  
  667.  
  668. 5.3.4 Quick Delete
  669.  
  670. You normally delete icons with the Del key. After pressing
  671. this key you will be prompted if you really wish to delete
  672. the icon.
  673.  
  674. If  you  want  to  delete icons fast however,  check  this
  675. option. You can then delete icons simply by dragging  them
  676. out  of the screen. You will not be prompted, the icon  or
  677. all icons selected in the current window will be deleted!
  678.  
  679.  
  680.  
  681. 5.3.5 Quick Search
  682.  
  683. You  can find an icon by using the scroll bar or by cursor
  684. keys.  If you want to find an icon quickly by name,  check
  685. this  option.  You may then simply type  a  name  to  find
  686. matching  icons.  IcoShow will locate  these  and  display
  687. successively.  If  no icons answer to the  search,  string
  688. will be deleted automatically. Otherwise you will have  to
  689. delete it yourself.
  690.  
  691. You can use the following characters:
  692.  
  693.  Letters/digits/./_    normal characters
  694.  ?                stands for any single character
  695.  *                stands for any number of characters
  696.  Space            deletes the string
  697.  Backspace        deletes   the  last  character  in   the
  698.                   string
  699.  
  700. You can see the current entered string in the status line.
  701.  
  702.  
  703.  
  704. 5.4  Window Menu
  705.  
  706. Use this menu to arrange and size windows within IcoShow.
  707.  
  708. Cascade          If  you  activate this option, all opened
  709.                  windows within IcoShow will be shown as a
  710.                  Cascade.
  711.                  Hotkey:  Shift-F5
  712.  
  713. Tile             If  you  activate this option, all opened
  714.                  windows within IcoShow will be tiled. You
  715.                  can see all windows displayed now.
  716.                  Hotkey:  Shift-F4
  717.  
  718. Minimize Windows If  you  choose this command, all windows
  719.                  within  IcoShow  will  be  minimized  and
  720.                  arranged  in  alphabetic  order  at   the
  721.                  bottom  of  the IcoShow desktop.  If  you
  722.                  have   created  many  windows,  use  this
  723.                  command  and the command Maximize Windows
  724.                  to rearrange all windows.
  725.                  If   this   option   is  activated,   new
  726.                  directories,  respectively windows,  will
  727.                  be shown minimized.
  728.  
  729. Maximize Windows If you choose this command, all minimized
  730.                  windows will be shown in default size and
  731.                  arranged in alphabetic order according to
  732.                  the tile or cascade option.
  733.  
  734. Select Window    Within  the following dialog box you  can
  735.                  choose a window quickly and activate it.
  736.  
  737. Close All        Use   this  command  to  close  all  open
  738.                  windows  at  once. Upon  closing  IcoShow
  739.                  tries  to release a maximum of heap space
  740.                  and resources.
  741.  
  742. Arrange Icons    Choose   this  command  to  arrange   all
  743.                  minimized  windows at the bottom  of  the
  744.                  IcoShow  desktop  according  to  Windows'
  745.                  settings. The windows will not be  sorted
  746.                  by name.
  747.  
  748.  
  749.  
  750. 5.5  Help Menu
  751.  
  752. Look  here  for informations about registration,  ordering
  753. and  the  present  use  of heap and  resources.  For  more
  754. details about the dialog boxes see chapter 6.
  755.  
  756. Contents         Choose this menu command for the contents
  757.                  of  the  help index. If you need help  at
  758.                  any  place type the F1 key. IcoShow  will
  759.                  try to find the proper help for you.
  760.  
  761. How to use help  At this place you get the general Windows
  762.                  help.
  763.  
  764.  
  765. Registration     The author's hints for  registering  and
  766.                  how to contact him.
  767.  
  768.  
  769. Print Order Form  If you  wish  to  order  a  license  for
  770.                  IcoShow, you can fill in the form  online
  771.                  and  print it from here. Switch  on  your
  772.                  printer!
  773.  
  774.                  After  printing the form is not saved  to
  775.                  disk. After you pressed the OK button you
  776.                  will  have  to fill it in anew  to  print
  777.                  another copy.
  778.  
  779. Set Register Information   After you register the program,
  780.                  you  can input your name and the received
  781.                  password in the following dialog box.  If
  782.                  the password contains spaces, please type
  783.                  the spaces too.
  784.                  IcoShow writes the informations into  INI
  785.                  file  and stores them under "Registered="
  786.                  and "Password=". The password will not be
  787.                  checked to this time!
  788.  
  789. About IcoShow    Use  this  to  display  informations   on
  790.                  copyright and the present use of heap and
  791.                  resources.
  792.  
  793.  
  794.  
  795. 5.6  Properties Menu
  796.  
  797. If  you  click  on  an icon with the right  mouse  button,
  798. IcoShow displays the properties Menu. In this menu you can
  799. select  another image if the icon has more than  one.  You
  800. can select the properties available for this icon, such as
  801. exclude,   delete,  edit  or  rename.  Only  the  possible
  802. Properties  will  be  displayed. In example  the  property
  803. "rename" is not available if you click on an icon  from  a
  804. library.
  805. Last but not least you can change the options to determine
  806. the function of the left mouse button.
  807.  
  808. IcoShow  tries  to  position the  proper  image  near  the
  809. current icon. Click on the image which you wish to use for
  810. further  processing. Note that you can  display  only  one
  811. image from an icon at any time. If IcoShow copies to  icon
  812. files,  it  will be copied all images. You can  choose  to
  813. write all images if you write icons into a library.
  814.  
  815. Exlude Icon      Choose this option if you wish to exclude
  816.                  the current icon from further processing.
  817.                  You  can  select this icon again  if  you
  818.                  change  the criteria for selecting and/or
  819.                  excluding  icons  (Select/Exclude  within
  820.                  Icons MenuIconMenu) or if you choose  the
  821.                  menu point Refresh from File Menu!
  822.  
  823. Delete Icon      Choose  this option if you wish to delete
  824.                  icons  from  disk too. You cannot  delete
  825.                  icons  from  libraries.  These  will   be
  826.                  deleted from display only.
  827.  
  828. Rename Icon      If  you  choose this option, you will  be
  829.                  prompted for a new name of the icon.  You
  830.                  cannot   rename   icons  from   libraries
  831.                  directly, however.
  832.  
  833.                  Check the  "Sort" box if you wish to sort
  834.                  the  display in the current window  after
  835.                  renaming. The icon will be displayed then
  836.                  at  its  proper place within  the  window
  837.                  according to its new name.
  838.  
  839. Edit Icon        If  you choose this option, IcoShow  will
  840.                  run the program from "Edit with".
  841.  
  842. Copy             You  can  drag  specific icons  or  icons
  843.                  symbolizing a minimized window containing
  844.                  icons  to  a destination window with  the
  845.                  mouse.  Place cursor on icon, press  down
  846.                  the left mouse button, then drag the icon
  847.                  to  its destination and release the mouse
  848.                  button.
  849.                  If  this  option is checked, the  icon(s)
  850.                  will be copied, not moved.
  851.  
  852. Move             You  can  drag  specific icons  or  icons
  853.                  symbolizing a minimized window containing
  854.                  icons  to  a destination window with  the
  855.                  mouse.  Place cursor on icon, press  down
  856.                  the left mouse button, then drag the icon
  857.                  to  its destination and release the mouse
  858.                  button.
  859.  
  860.                  If  this  option is checked, the  icon(s)
  861.                  will  be  moved, not copied.  This  means
  862.                  that  the icon files in the source window
  863.                  will be deleted after copying. Icons from
  864.                  libraries (Exe/Dll/Nil/Icl) will  not  be
  865.                  deleted, but copied.
  866.                  If  the  source  window  is  empty  after
  867.                  moving  icons, you will be  prompted  for
  868.                  deletion of the directory.
  869.  
  870.                  Hint : Icons with identical names in  the
  871.                          source       and      destination
  872.                          directories will not  be  deleted
  873.                          because they will not be moved.
  874.  
  875. Rename           If this option is checked, you can rename
  876.                  icons by a double clicking them with  the
  877.                  mouse or by pushing the Return key. Icons
  878.                  cannot  be renamed and moved at the  same
  879.                  time.
  880.                  If  you  wish  to sort the icons  in  the
  881.                  current  window  after  the  renaming  is
  882.                  done, check the sort button.
  883.                  You cannot rename icons in libraries.
  884.  
  885. Edit             If this option is checked, a double click
  886.                  with the mouse or the Enter key will  run
  887.                  the  command  under  "Edit  with..."   in
  888.                  Options  Menu  for the icon selected.  If
  889.                  the  editor chosen is capable of  command
  890.                  line  processing, the icon will be opened
  891.                  and displayed for further processing.  If
  892.                  not, you will still have to open the icon
  893.                  you wish to alter.
  894.  
  895.  
  896.  
  897. 6. Dialog Boxes
  898.  
  899. 6.1  Open
  900.  
  901. Add  a new window (or new windows) with the icons existing
  902. in  a given directory. The dialog box allows you to browse
  903. for   the   directory   wanted  and   to   check   whether
  904. subdirectories  and/or  icon libraries  (...)  are  to  be
  905. included  and whether IcoShow is to look for  and  display
  906. icon names found in some libraries.
  907.  
  908. Drives and Directories  Browse for the  name  of  a  drive
  909.                  and/or directory or enter it in the  list
  910.                  box below. If you click the OK button  or
  911.                  press  the Return key, processing of  the
  912.                  directory will start.
  913.  
  914. Subdirectories   Select  this option if you wish  to  look
  915.                  for  icons in subdirectories of the  main
  916.                  directory  or  drive  chosen,  too.  Each
  917.                  directory containing icons will be  shown
  918.                  as  a separate window.
  919.  
  920. Libraries        Check this box if you want to search  for
  921.                  icons included in library files, too. You
  922.                  may   check   all  types   of   libraries
  923.                  supported  (Exe/Dll/Nil/Icl)  or   select
  924.                  specific ones.
  925.  
  926. Search for Names Many icon libraries include names for the
  927.                  icons. If you wish to display those names
  928.                  along with the icons, check this box.
  929.  
  930.                  If this option has not been checked or if
  931.                  there are no names assigned to the icons,
  932.                  the library's name is used, suffixed by a
  933.                  running number.
  934.  
  935.  
  936.  
  937. 6.2  Print Icons
  938.  
  939. This  dialog box will open after you have issued the Print
  940. Icons command in the File Menu.
  941. By  checking the print names box you will have  the  names
  942. assigned  to  the  icons  printed along  with  the  design
  943. itself.
  944.  
  945. If printer initialisation is succesful, the next dialog box
  946. will be displayed. Press the Cancel button if you wish  to
  947. cancel the printing.
  948.  
  949.  
  950.  
  951. 6.3  Create Library
  952.  
  953. In  this  dialog box you can set the options to  create  a
  954. library.  If  the  library already  exists,  you  will  be
  955. prompted to delete it before you go on.
  956. IcoShow can put over 2,700 icons (images) in a single icon
  957. library. But if you want to use the library later with the
  958. program  manager, you should not include more  than  1,200
  959. icons (images). IcoShow will issue a warning.
  960. Only  the  icons selected will be written to the  library.
  961. Please  check Select/Exclude in Icons Menu to see if  your
  962. choice corresponds with your intentions.
  963.  
  964. Library Name    Enter  the  name  of the library  in  this
  965.                 field  or  select  it from  the  list  box
  966.                 below.
  967.  
  968.                 Default name for the library is ICONS.DLL.
  969.                 IcoShow  will write the last name used  to
  970.                 the  INI  file if you have selected  "Save
  971.                 Settings" in the Option Menu.
  972.  
  973. Library Type    Choose  the  type of library you  wish  to
  974.                 create  here. Supported are DLL,  NIL  and
  975.                 ICL files.
  976.  
  977. Current Only    Check  this box if you wish to write  only
  978.                 the icons in the current window.
  979.  
  980. Selected Only   Check  this box if you wish to write  only
  981.                 the icons in the windows selected. You can
  982.                 select these windows in the "Select Window
  983.                 Dialog Box" from Window Menu.
  984.  
  985. All Windows     Check  this box if you wish to  write  all
  986.                 the icons selected from all windows.
  987.  
  988. Sort            Check this box to write all icons selected
  989.                 in  alphabetic order. If this box  is  not
  990.                 checked,   the  icons  will   be   written
  991.                 successively.
  992.  
  993.                 IcoShow sorts the pathnames of the windows
  994.                 in alphabetic order, ascend if windows are
  995.                 minimized  and  descend  if  windows   are
  996.                 maximized  or  normally  shown  (see  also
  997.                 "Minimize Windows" and "Maximize  Windows"
  998.                 under Window Menu).
  999.  
  1000. Write Names with Icons    Check this box to write icons to
  1001.                 the  library  including  their  names.  If
  1002.                 icons  have  no names, IcoShow will  build
  1003.                 names  using up to 5 characters  from  the
  1004.                 library's  name  and a 3  character  index
  1005.                 including  only letters and digits  (46656
  1006.                 variants).
  1007.  
  1008. Exclude Duplicates   Check this box to instruct IcoShow to
  1009.                 compare   all   icons   and   to   exclude
  1010.                 duplicates  from  all  the  icons  to   be
  1011.                 written to the library.
  1012.  
  1013.                 You  can use this possibility to eliminate
  1014.                 duplicate  icons from your directory  even
  1015.                 if you want them as .ICO-files.  Write all
  1016.                 icons  to  a  library while  this  box  is
  1017.                 checked,  delete  icon files  and  extract
  1018.                 them from the library again.
  1019.  
  1020. Write all Images Some icons include more than one image for
  1021.                 displays with different numbers of colors.
  1022.                 Normally  the  image  selected  for   your
  1023.                 display will be written to the library. If
  1024.                 this  box  is checked, IcoShow will  write
  1025.                 all  images  to  the  library.  That  will
  1026.                 minimize the number of stored icons!
  1027.  
  1028. If  you overwrite an old library, you need disk space  for
  1029. both the old and the new version.
  1030.  
  1031.  
  1032.  
  1033. 6.4  Select Icons
  1034.  
  1035. In  this  dialog  box you can enter the  pattern  used  to
  1036. select  icons  for  processing.  For  more  details  about
  1037. pattern see chapter 5.
  1038.  
  1039.  
  1040.  
  1041. 6.5  Exclude Icons
  1042.  
  1043. In  this  dialog  box you can enter the  pattern  used  to
  1044. exclude  icons  from  processing. For more  details  about
  1045. pattern see chapter 5.
  1046.  
  1047.  
  1048. Please  watch  out  for interactions  between  Select  and
  1049. Exclude.  You can write patterns in the INI file  manually
  1050. to  select/exclude icons while IcoShow  is  starting.  All
  1051. patterns  you  have entered while IcoShow is running  will
  1052. not be written to INI file!
  1053.  
  1054.  
  1055.  
  1056. 6.6  Edit with ...
  1057.  
  1058. In  this dialog box you can enter the command line used to
  1059. start  icon processing, usually the complet path to  start
  1060. the icon editor of your choice. The name of the icon to be
  1061. edited  will be added when the command is issued,  so  the
  1062. editor  will  open with the icon already  displayed.  This
  1063. will  work  only if the editor is capable of command  line
  1064. processing.
  1065.  
  1066.  
  1067.  
  1068. 6.7  Rename Icon
  1069.  
  1070. In  this  dialog  box you can enter a  new  name  for  the
  1071. selected  icon.  You  cannot rename icons  from  libraries
  1072. directly, however.
  1073.  
  1074. Sort            Check the  "Sort" box if you wish to  sort
  1075.                 the  display  in the current window  after
  1076.                 renaming. The icon will be displayed  then
  1077.                 at  its  proper  place within  the  window
  1078.                 according to its new name.
  1079.  
  1080.  
  1081. 6.8  Select Window
  1082.  
  1083. This  dialog box will help you to select a window  quickly
  1084. or  to  calculate the number of icons which  you  wish  to
  1085. write to a library. Use the Shift key to select more  than
  1086. one window.
  1087. If  only  one  window is highlighted this window  will  be
  1088. activated  if  you press the Enter key  or  click  the  OK
  1089. button.
  1090.  
  1091.  
  1092.  
  1093. 6.9  Registration
  1094.  
  1095. You will get familiar with this dialog box if you have not
  1096. registered by December 31st, 1992.
  1097.  
  1098.  
  1099.  
  1100. 6.10 Print Order Form
  1101.  
  1102. In  this dialog box you may fill in the text for the order
  1103. form. Printing starts after the print button was clicked.
  1104.  
  1105. After  printing the form is not saved to disk.  After  you
  1106. pressed the OK button you will have to fill it in anew  to
  1107. print another copy.
  1108.  
  1109. If you fill in the EMail address (or the network path),  I
  1110. will  send  you  a message after I have a new  version  on
  1111. CompuServe.
  1112.  
  1113. Please  use  payment per VISA or Mastercard if you are not 
  1114. from  Germany. If  you  decide  to do so, IcoShow displays 
  1115. the  following  dialog box  to prompt  you  for  the  Card  
  1116. Number and the Release Date:
  1117.  
  1118. Enter the correct Card Number and the Release Date of your
  1119. Credit Card. IcoShow checks your entries and will not allow
  1120. you to enter incorrect statements.
  1121. If  you  wish to change a correct credit card number,  you
  1122. must  first  close the dialog box "Print Order Form"  with
  1123. the OK button and open it again.
  1124.  
  1125.  
  1126.  
  1127. 6.11 About IcoShow
  1128.  
  1129. Here  are copyright messages and some informations on heap
  1130. and resources used.
  1131.  
  1132. "Free Heap"    shows  you the minimum of local and  global
  1133.                heap. That will be sure the minimum of  the
  1134.                local heap.
  1135.  
  1136. "Free Resources"     shows  you the minimum of  the  local
  1137.                heap from User and GDI.
  1138.  
  1139. "Processed Icons"    shows  you the amount of  icons  read
  1140.                overall.
  1141.  
  1142. Check  these informations. If you see that "Free Heap"  is
  1143. very  small, close windows to free local heap. An overflow
  1144. in local heap stops IcoShow immediately.
  1145.  
  1146. If  there  are no more windows or dialog boxes  displayed,
  1147. you have too many opened windows.
  1148.  
  1149.  
  1150.  
  1151. 7. Status Line
  1152.  
  1153. The standard status line offers the following informations:
  1154.  
  1155. Status of the Status     of Number      of Number     of
  1156. menu commands the      menu icons     read icons      in
  1157. Copy  /  Move command       and   selected current
  1158. within    the Rename      / and        the window.
  1159. Icons Menu.   Edit   within number      of
  1160.               the     Icons opened
  1161.               Menu.         windows.
  1162.  
  1163.  
  1164.  
  1165. If  the option "QuickSearch" in Icons Menu is checked  and
  1166. you  have entered a search string, the status line  offers
  1167. the following informations:
  1168.  
  1169. Status of the Status     of Number      of Entered
  1170. menu commands the      menu icons     read Substring.
  1171. Copy  /  Move command       and   selected
  1172. within    the Rename      / and        the
  1173. Icons Menu.   Edit   within number      of
  1174.               the     Icons opened
  1175.               Menu.         windows.
  1176.  
  1177.  
  1178.  
  1179.  
  1180. 8. Hints for the use of IcoShow
  1181.  
  1182. Here  are  some  hints about the (more) effective  use  of
  1183. IcoShow:
  1184.  
  1185.    1.     If  you  install ICO files into program manager,
  1186.      create   a  directory  where  you  save  this   files
  1187.      together. Than you can see all at once.
  1188.    
  1189.    2.     If  you plan to copy or move many icons,  create
  1190.      a  temporary directory and copy the icons there. This
  1191.      does  not  take a long time and you have  been  saved
  1192.      your  icons if you make a mistake. If you are  ready,
  1193.      delete the directory with the icons.
  1194.    
  1195.    3.     Be  careful to install icons to program  manager
  1196.      if  there are bad program icons especially in windows
  1197.      3.0.  Because  errors in this case will not  reported
  1198.      from  IcoShow  but from the program  manager  Windows
  1199.      could  hang. If that happened, try to use Alt-ESC  to
  1200.      change to the task manager and then back to IcoShow.
  1201.    
  1202.    4.  If  you install icons while Norton Desktop (version
  1203.      1.0)  is  running, install only icon  files.  Because
  1204.      there  is  a  bug in Norton's task manager  the  heap
  1205.      space will be lost if you install icons from a dll.
  1206.    
  1207.    5.     If  you wish to use another background color for
  1208.      your  icons, then load control panel and  select  the
  1209.      color.  Then write the RGB values into the  INI  file
  1210.      of IcoShow under BackColor (see upon).
  1211.    
  1212.    6.     Icons  or all icons selected in a window can  be
  1213.      deleted  by  the  DEL  key (you cannot  delete  icons
  1214.      within  libraries). If you are an  experienced  user,
  1215.      you  can  delete them simple by dragging them outside
  1216.      of  screen. Choose "QuickDelete" from Options Mene to
  1217.      do  so.  Please be careful because IcoShow  does  not
  1218.      undelete icons!
  1219.    
  1220.    7.       Please    note    the    difference    between
  1221.      "QuickSearch"   and   the   options   "Select"    and
  1222.      "Exclude".  QuickSearch navigates only  to  a  proper
  1223.      symbol   in   current  window  while   Select/Exclude
  1224.      chooses  the  icons for display and  process  in  all
  1225.      windows.
  1226.    
  1227.    8.      If   you   get   the   message   "Overflow   in
  1228.      local/global  heap",  close  windows   or   work   in
  1229.      enhanced mode.
  1230.      If  you   get   the  message  "No  more   space   for
  1231.      resources", IcoShow will not exit rather  than  icons
  1232.      will   be   displayed  as  question  marks.  Minimize
  1233.      windows to free resources.
  1234.    
  1235.  
  1236.  
  1237. 9. Shareware Version
  1238.  
  1239. You  can  use the not registered version of IcoShow  until
  1240. February,  28th 1993 for evaluation. Please do  not  patch
  1241. the program and especially do not change my name.
  1242.  
  1243. If  you register the program for $35 (60 DM with Germany),
  1244. I will send you a printed documentation.
  1245.  
  1246. If you need support, write me a letter to my address below
  1247. or send me a fax or mail. I will try to help you anyway.
  1248.  
  1249.  
  1250.  
  1251. My address :     Harald Pitro
  1252.                  Hermann-Wuensche-Strasse 11
  1253.                  O - 8705 Ebersbach / Sachsen
  1254.                  Germany
  1255.  
  1256. Mail to:         Phone       +49-3586-5186
  1257.                  CompuServe  100024, 2662
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263. Ebersbach January, 13th 1993
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.                                      Harald Pitro
  1271.  
  1272.